home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / graphics / vesavw28.zip / VESAVIEW.DOC next >
Text File  |  1992-11-23  |  40KB  |  707 lines

  1. ============================================================================
  2. VESAVIEW - Keywords: VESA GIF PCX BMP TGA IMG TIF HPGL PRINT CATALOG VIEWER
  3.                      PAN DESKJET LASERJET PAINTJET
  4.            Brief Desc: View and print GIF, PCX, BMP, TGA, TIF & IMG/GEM
  5.            images & HPGL plotter files.  Arrays of up to 81 images/screen
  6.            can be generated and saved for easy cataloging.  HPGL plot files
  7.            can be saved as IMG files.  Mouse support.  Requires a VESA driver
  8.            for your graphics card and enough extended memory to hold entire
  9.            image.  Supports VESA modes thru 1280x1024x256. Size of image is
  10.            limited only by the amount of extended memory. Quick panning of
  11.            images larger than your screen resolution. Color/brightness/
  12.            contrast adjustments, scaling & cropping of color images. 24 bit
  13.            color reduction for BMP, TGA & PCX. Excellent B&W printing to HP
  14.            DeskJet and LaserJet. Superb color printing to HP PaintJet,
  15.            PaintJet XL,PaintJet XL300, and DeskJet 500C/550C,.
  16.  
  17. ============================================================================
  18.  
  19. VESAVIEW  -  Copyright (c) William M. White 1992.
  20.              Compuserve ID: 71770,2340
  21.  
  22.         This product is Shareware. If you find it useful, please register
  23.         your copy and tell your friends about it.  This product may not be
  24.         sold or packaged, either individually, or as part of any other
  25.         product without the express written consent of the author. This
  26.         product may not be changed or altered and then distributed without
  27.         the express written consent of the author.  The VESAVIEW.DOC file
  28.         must accompany VESAVIEW.EXE whenever the non-registered version is
  29.         distributed.
  30.  
  31. REGISTRATION:
  32.         Please send your $30.00 registration fee to:
  33.                 William M. White
  34.                 P. O. Box 2273
  35.                 Glen Allen, VA. 23058-2273
  36.  
  37.         By Registering your copy, you will receive an un-hindered copy of
  38.         the latest version of VESAVIEW and help support the continued
  39.         development of the product.  Current shareware versions of the
  40.         product will always be available on Compuserve in the GRAPHSUPPORT
  41.         forum (GO PICS). Your registered copy of the program should never
  42.         be distributed since it will be encoded with your name.
  43.  
  44. DISCLAIMER:
  45.         VESAVIEW is offered to you on an as-is-basis without any guarantee
  46.         as to the correct functioning or fitness for specific purpose.  The
  47.         author believes this program to work as described but you use the
  48.         program entirely at your own risk.  The author will not be
  49.         responsible for any hardware or software damage, loss of data, or
  50.         incidental or consequential damage that may result from its use,
  51.         whether or not such use is in accordance with the instructions.
  52.  
  53. REVISION HISTORY:
  54.         v1.0 - v1.9     - Developmental versions
  55.         v2.0 (04/03/92) - First release to the Public as Shareware
  56.         v2.1 (04/10/92) - Changed algorithum used for arrays color palette.
  57.                           Now uses color dithering for much more accurate
  58.                           color reproduction.
  59.         v2.2 (04/21/92) - Added new option to Automatically generate
  60.                           multiple pages of array images and save them
  61.                           to GIF files without user intervention. Also
  62.                           added a Scaling option.
  63.         v2.3 (04/27/92) - Fixed a minor bug while displaying multiple pages
  64.                           of arrays.
  65.         v2.4 (06/05/92) - Changed GIF decoder so that files which do not
  66.                           follow the standard of setting byte 13 of header
  67.                           as a zero are decoded anyway.
  68.         v2.5 (07/06/92) - Added saving as PCX files (both 2 & 256 color).
  69.                           Added cmd line qualifiers /FN, /FB & /FW so that
  70.                           scaling of B&W images could retain more info of
  71.                           the original.  Can now read in Windows 3.X
  72.                           .BMP files (256 color).  Added ability to select
  73.                           files for display with a search string.  Added
  74.                           AA (absolute arc) & CI (circle) cmds to HPGL
  75.                           module & fixed minor bug in display size.
  76.         v2.6 (07/16/92) - Added decoding of TIF (2 color) files and fixed
  77.                           bug with Filename Search option. Only decodes
  78.                           non-compressed and run-length encoded TIFs.
  79.         v2.7 (10/09/92) - Added decoding of 24 bit PCX & BMP files and
  80.                           decoding of 16, 24 & 32 bit TGA (Targa) files.
  81.                           Added ability to change command line options from
  82.                           within the program from a menu.
  83.         V2.8 (11/20/92) - Added qualifier to disable beep after displaying
  84.                           images. Added print enhancements:  Color printing to
  85.                           HP Paintjet, Paintjet XL, PaintJet XL300, HP DeskJet
  86.                           500C & 550C.  REGISTERED VERSION ONLY: Added ability
  87.                           to select plot size, resolution, rotation angle,
  88.                           gamma correction and placement on page.  Data being
  89.                           sent to printer can now be compressed to reduce size
  90.                           of transfer and speed up printing.
  91.  
  92. NOTE:   The annoying beeps and NON-Registered notices will be removed
  93.         from registered copies.  Also, the NON-Registered version does not
  94.         support the new printing options (sizing, rotating and positioning).
  95.  
  96. REQUIREMENTS:
  97.         - IBM compatible 286 or better
  98.         - Extended memory (and driver such as HIMEM).  For 256 (& higher)
  99.           color files, you'll need 1 byte/pixel in your image.  For 2 color
  100.           files, you'll need 1 byte per 8 pixels in your image.  This program
  101.           conforms to XMS 2.0 specification.
  102.         - Will use a math coprocessor if available
  103.         - A graphics card that supports the VESA BIOS EXTENSIONS for the
  104.           'Super VGA modes' either through hardware or a software driver.
  105.  
  106. FEATURES:
  107.         - Will read in any size up to 1024 x 1280:
  108.                 GIF (Compuserve 87a) - 256 color
  109.                 PCX (Zsoft) - B & W, 8 & 24 bit
  110.                 BMP (Windows) - 256 color & 24 bit (16 million colors)
  111.                 TGA (Targa) - 16, 24 & 32 bit (non-compresssed RGB &
  112.                               Run length encoded RGB)
  113.                 IMG (GEM/Digital Research Inc) - B & W
  114.                 TIF - B & W (non-compressed & run length encoded)
  115.                 HPG - (Hewlett Packard) HPGL plot files (.HPG or .PLT)
  116.  
  117.         - If the file is larger than the screen mode you selected, you can
  118.           quickly pan around the image.  Size of image is limited only by
  119.           the amount of extended memory you have.  NOTE:  The entire image
  120.           is read into Extended memory to allow for quick panning of large
  121.           images.  Black & White images are stored in memory with 1 byte
  122.           per 8 pixels. 256 color (8 bit) images are stores in memory with
  123.           1 byte per pixel.  24 & 32 bit images are stored in memory as 256
  124.           color images so only 1 byte per pixel is required.
  125.  
  126.         - Black & White printing (color images will be halftoned) and Color
  127.           printing supported.  In Registered Version, Prints can be sized,
  128.           rotated and positioned on paper.
  129.  
  130.         - Red/Green/Blue/Contrast/Brightness values may be changed while
  131.           viewing a color image.
  132.  
  133.         - Color screen images can be saved as a 256 color GIF or PCX file.
  134.           These images may be cropped & scaled before saving.
  135.  
  136.         - Black & White images can be saved as an IMG or 2 color PCX file.
  137.           This is useful to save a HPGL file that is displayed on screen
  138.           out to a quicker retrieving raster file.  If these images are
  139.           displayed in a color VESA mode they can also be saved &/or cropped
  140.           as 256 color GIF or PCX files.
  141.  
  142.         - Arrays of up to 81 images can be displayed on a single screen at
  143.           once.  This screen can then be saved as a single GIF or PCX file
  144.           for cataloging or printing.
  145.  
  146.         - Supports VESA modes (assuming your graphics card can handle):
  147.                 100 -  640 x  400 x 256
  148.                 101 -  640 x  480 x 256
  149.                 103 -  800 x  600 x 256
  150.                 105 - 1024 x  768 x 256
  151.                 107 - 1280 x 1024 x 256
  152.         - Will support a 800 x 600 x 2 color B&W mode if your card has one.
  153.           (See /SVn option below)
  154.  
  155.         - Supports the use of a MicroSoft compatible 2-button mouse.
  156.  
  157. RUNNING:
  158.         Make sure you have enough extended memory available and that a
  159.         driver (such as HIMEM) is loaded.  Make sure your graphics card
  160.         has VESA BIOS EXTENSIONS (VBE) either built-in or that you have
  161.         installed a VESA software driver.
  162.  
  163.         Keyin VESAVIEW [/P1 or /P2] [/AB or /AW] [/LOmode] [/AMmode]
  164.                        [/WN, /WH or /WF] [/Dn] [/SVn] [/FN, /FB or /BW]
  165.                        [/CO or /CS] [/PTDJ, /PTLJ, /PTPJ, /PTPJXL,
  166.                        /PTPJXL3 or /PTDJC] [/PWn] [/PAn] [/PRn] [/PTMn]
  167.                        [/PLMn] [/PC] [/PGn] [/NB]
  168.                        where items in brackets are optional.
  169.  
  170.         NOTE: Options with an Asterisk (*) are only available in the
  171.               REGISTERED VERSION.  The optional qualifiers can be changed
  172.               while in the program by pressing <Q> or pointing to QUALS
  173.               with the mouse.  These changes are only for the current
  174.               session and will not be saved.  If you wish to use the same
  175.               qualifiers each time you envoke the program, write a BAT file
  176.               such as:
  177.  
  178.                  CD \GIF         rem Assumes your graphics files are here
  179.                  \VV\VESAVIEW /P1 /NW /CO   rem Assumes program in VV dir
  180.  
  181.         The /P1 or /P2 designates which printer port to use for printing
  182.         (LPT1 or LPT2).
  183.  
  184.         The /AB forces the array mode to use a black background and white
  185.         text for the filenames.  The /AW forces the array mode to use a
  186.         white background and black text (saves black ink when printing).
  187.  
  188.         The /LOmode (where mode is 100, 101, 103, 105 or 107) will lock
  189.         out a mode.  This is useful if your VESA driver is designed for
  190.         a graphics card which has been fully populated with memory chips
  191.         but your card doesn't have all of this memory installed.  You may
  192.         use more than one of these switches on your command line.
  193.         
  194.         The /AMmode (where mode is 100, 101, 103, 105 or 107) will let you
  195.         default to a specific mode when displaying arrays.  The program
  196.         will default to mode 101 if this switch is not used.  Only use a
  197.         mode number that your card can support!
  198.  
  199.         The /WN (no weight) will not display weights of lines in an HPGL
  200.         plot file if the SP (select pen) keyword was used when creating
  201.         the plots.  This will greatly speed up the screen drawing if you
  202.         don't need to look at or print the weights.  Some CAD programs
  203.         which generate the plot files create weighted lines by simply
  204.         drawing the lines multiple times in the plot file (each slightly
  205.         offset) and not by using the SP (set pen) command.  The /WN & /WH
  206.         switches will have no effect on this type of plot files.
  207.  
  208.         The /WH is similar to /WN except that the weights of lines will be
  209.         halved (divided by 2).  The /WF (full weights) will display the
  210.         weights as originally drawn.
  211.  
  212.         The /Dn is for setting the delay in seconds to use between
  213.         slides.  The n is an integer number from 1 to 999 and defaults
  214.         to 5 seconds.  This time is approximate and will vary depending
  215.         on the size of the image being read in.
  216.  
  217.         The /SVn will allow you to use a 800 x 600 x 2 color mode to
  218.         display IMG or HPGL files in a high resolution mode if your
  219.         graphics card supports it.  The n is the decimal mode number
  220.         that your card uses for this mode.  Most Paradise cards use 41
  221.         decimal for this mode, and the Tseng cards (including Orchid)
  222.         use 89 decimal.  This special mode and the standard 640 x 480 x 2
  223.         mode will allow faster panning on screen than the same resolutions
  224.         in VESA modes will for large B & W images.  NOTE: The panning icon
  225.         which is available in VESA modes is not available for B & W modes.
  226.  
  227.         The /FN, /FB or /FW specify the foreground color (N=none, B=Black
  228.         and W=White) of your Black & White images.  By specifying foreground
  229.         color, the program will be able to save more of your image's
  230.         original context when scaling down.  This qualifier works best if
  231.         your images are line drawings and not pictures.  For example, if
  232.         your image appears on the screen as black lines on a white
  233.         background, use the /FB qualifier.  If your images don't have a
  234.         main foreground color such as the case with pictures, use /FN. Note
  235.         that using either the /FB or /FW qualifiers will increase the
  236.         processing time for B&W scaling & printing.  If you don't need the
  237.         increased quality, use /FN.
  238.  
  239.         The /CS (color-standard) will force 16, 24 & 32 bit images to be
  240.         displayed using a standard palette.  The colors will be adequate for
  241.         previewing, but for more exact colors, use the /CO.
  242.  
  243.         The /CO (color-optimized) will force 16, 24 & 32 bit images to be
  244.         processed using an optimized 256 color palette.  The process reads
  245.         in all the colors in your image, creates a histogram of the most
  246.         used colors, and then creates an optimized palette of the results.
  247.         The processing time is greater than if the /CS option is used,
  248.         but the results are spectacular.  The color reduction method used
  249.         is much faster than that of other program that I have tested.  After
  250.         the images has been displayed on the screen, you might want to save
  251.         it as a 256 GIF or PCX file, so that the next time you want to
  252.         display it, you can use the quicker GIF or PCX version.
  253.  
  254.         The /PTx (printer type) is used to select your printer.  It can
  255.         be one of the following: /PTDJ (HP DeskJet), /PTLJ (HP LaserJet),
  256.         /PTPJ (HP PaintJet), /PTPJXL (HP PaintJet XL), /PTPJXL3 (HP PaintJet
  257.         XL300) /PTDJC (HP DeskJet 500C or 550C).
  258.  
  259.       * The /PWn (print width) is used to specify a print width.  It is a
  260.         decimal value from 0.0 to 10.5.  If you enter a number greater than
  261.         8.0, the print will automatically be rotated 90 degrees.  The print
  262.         width represents the width that you want the horizontal image
  263.         dimension as seen on your screen to be printed, no matter what
  264.         rotation angle you use.
  265.  
  266.       * The /PAn (print angle) is used to rotate your print on the printed
  267.         page.  Values for n can be 0, 90, 180 or 270.
  268.  
  269.       * The /PRn (printer resolution) is used to specify the resolution in
  270.         dots per inch (dpi) of your active printer.  For the DeskJet series,
  271.         it can be 75, 150 or 300.  For the PaintJet series, it can be 90 or 180.
  272.  
  273.       * The /PTMn (printer top margin) sets the number of inches from the
  274.         current position of printhead that the image will start printing.  It
  275.         is a decimal value from 0.0 to 10.0.  If set to 99, your image will be
  276.         centered from top to bottom.
  277.  
  278.       * The /PLMn (printer left margin) sets the number of inches from the
  279.         left side of page that the image will start printing.  It is a decimal
  280.         value from 0.0 to 7.5.  If set to 99, your image will be centered from
  281.         left to right.
  282.  
  283.       * The /PC option will force the transfer of data from your computer to
  284.         the printer to be in a compressed (encoded) format.  This will speed
  285.         up the transfer of data (especially for serial or networked printers)
  286.         and time-savings will vary depending on the type and size of plot. In
  287.         some cases, you may find no time-savings overall since the printer
  288.         has to decompress the data, but your CPU should be freed up from
  289.         processing sooner. (default is no compress)
  290.  
  291.         The /PGn (print gamma) option will allow you to adjust the gamma of
  292.         your color print.  Simply put, gamma correction will adjust the
  293.         intensities of red, green & blue values logarithmically since the
  294.         human eye's perception of color intensity is non-linear.  The gamma
  295.         value is a decimal value between 0.5 and 2.0.  If set to 0, no gamma
  296.         correction will be performed.  If this qualifier is not used, gamma
  297.         defaults to a value best suited for the printer type selected.  Using
  298.         higher values will result in the darker colors in your image being
  299.         printed lighter.
  300.  
  301.         The /NB (No beep) option will disable the beep after displaying
  302.         images on the screen.  Default is to beep.
  303.  
  304.         SYSTEM DEFAULTS: /P1 /AB /AM101 /D3 /WF /FB /CO /PTDJ /PW8.0 /PA0 /PR0
  305.                          /PTM0.0 /PLM0.0
  306.  
  307.         Ex:  VESAVIEW /L2 /AW /D10  - Will use printer port LPT2:, display
  308.                                       arrays with a white background, and
  309.                                       delay 10 seconds between slides.
  310.  
  311.         Ex:  VESAVIEW /LO105 /LO107 /AM103 - Will lockout modes 105 and
  312.                                              107 from being valid VESA
  313.                                              modes and will use mode 103
  314.                                              when displaying arrays.
  315.  
  316.         The program will test to see if your graphics card supports the
  317.         VESA Bios Extensions by either hardware or software driver,
  318.         whether you have a HIMEM driver loaded and how much extended
  319.         memory you have available.
  320.  
  321.         Use the <ESC> key to exit program.  A mouse button can not be used
  322.         to exit the program.
  323.  
  324. CHANGING DIRECTORY:
  325.         While the list of files is on your screen, you can change your
  326.         current directory by placing the cursor on the lite blue entries
  327.         (which are directory names) and pressing <ENTER>.  The . (single
  328.         dot) will take you back to the root directory, and the .. (double
  329.         dots) will take you back one directory level.
  330.  
  331.         You can also press the <C> or <P> key to keyin a path that can include
  332.         a new disk drive. (Ex: B:\ or C:\GIF or C:\IMAGES\GIF or \GIF)
  333.  
  334. VIEW SINGLE IMAGE:
  335.         To view a single image move the cursor (with arrows, pageup,
  336.         pagedown, home or end keys) to the desired image file and press
  337.         <ENTER>.  Then select a Vesa Mode from the Mode Menu. An asterisk
  338.         denotes the Best Mode (calculated by the program) which will display
  339.         the most of your entire image on a single screen in the best
  340.         resolution.  After your image is displayed, press <ESC> to return
  341.         to main menu.  Note that when viewing IMG files or HPGL files,
  342.         you can use a VESA mode (only B&W colors used), use the standard
  343.         640 x 480 x 2 mode or use the Super VGA mode that you optionally
  344.         entered on the command line.  Entries in gray on the Mode Menu
  345.         are not available for your graphics card.
  346.  
  347. VIEW MULTIPLE IMAGES (slide show):
  348.         To view multiple images as a 'slide show', use the space bar to
  349.         select the images you wish to view.  You can mark all images in
  350.         the current directory with the <M> key or unmark them with the
  351.         <U> key.  These can include GIF, PCX, BMP, TGA, IMG, TIF, PLT and
  352.         HPG files.  By pressing the <C> key, you can change your current
  353.         Disk &/or Directory.  Press <ENTER> to start the slide show.  The
  354.         files will be displayed one by one in the best VESA mode as
  355.         determined by the program (640x480x2 mode is used for PLT & HPG
  356.         files).  The delay between slides will vary depending on the time
  357.         it takes to read in the next file while one is on your screen and
  358.         the value used in the  /Dn switch.  After the last file is
  359.         displayed, the program will loop back to first slide.  Pressing
  360.         <ESC> during the display will stop the slide show after the next
  361.         slide is displayed. (this may take several seconds)
  362.  
  363. VIEW AN ARRAY OF IMAGES:
  364.         To view multiple images on a single screen at once, use the space
  365.         bar to select the images you wish to view.  These can include GIF,
  366.         PCX, BMP, TGA, TIF and IMG files but not PLT or HPG files.  Press
  367.         <A> to select array display.  Select the VESA mode from Mode Menu
  368.         and then select the number of images to display per screen page.
  369.         Then sit back and watch your images appear.  Pressing <ESC> will
  370.         abort the display after the current image is displayed.  If more
  371.         than one page is required, you could press <G> to save the currently
  372.         displayed page as a GIF image or <Z> for ZSoft PCX image or
  373.         <PAGE DN> will continue to display the next page.
  374.  
  375.         Since each image uses it own unique 256 colors, a special optimized
  376.         color table and color dithering is used to display arrays.  Note
  377.         that when displaying a 2-color file in an array, the scaling down of
  378.         the original image (especially a line type drawing) will cause much
  379.         of the info to be lost on the screen unless the /FB or /FW command
  380.         qualifier is used.
  381.  
  382. AUTO ARRAY GENERATION/SAVING:
  383.         If you are going to have many pages (screens) of array images and
  384.         you will be saving them all out as GIF files, you can do this
  385.         automatically by using the <Gen> option.  This will automatically
  386.         display the arrays on the screen and then save them out without any
  387.         user intervention until the last one is processed.  You begin just
  388.         as you would for the standard array option by selecting the files
  389.         to display, the VESA mode, and then the number of images/page.
  390.         Then you are prompted for the first 1-6 characters of the filename
  391.         that the program will use for the GIF files it generates.  The
  392.         system will append a 2 digit page number and '.GIF' to your input.
  393.         
  394.         EX:  You are going to have 3 pages of array images and you enter
  395.              TEST as the filename.  The System will generate 3 files named
  396.              TEST01.GIF, TEST02.GIF & TEST03.GIF.
  397.  
  398. VIEWING HPG or PLT FILES:
  399.         To view a plot file created in a HPGL format, move the cursor to
  400.         the filename and press <ENTER>.  Then choose the Display Mode and
  401.         Plot Mode you wish to use.  The program will try and determine the
  402.         size of plot from the plot file header, but some CADD packages
  403.         don't supply this info in which case the program will assume a
  404.         "C size".  The HPGL codes for Plot Sizes are:
  405.                 PS4 = 'A' size
  406.                 PS0 = 'B' size
  407.                 PS1 = 'C' size
  408.  
  409.         Choosing a display mode of FIT, 2X or 4X will speed up the drawing
  410.         process but the resolution of the image will be diminished.  You
  411.         will only be able to plot an "A size" or smaller.  As the image is
  412.         decoded, you will see it being drawn in a preview mode at screen
  413.         size.  After the image is complete, pressing any key will swap you
  414.         to the actual image as stored in Extended memory for panning
  415.         around in.  Pressing <ESC> as the image is being decoded will
  416.         abort it.
  417.  
  418.         Currently supported HPGL commands are:  PU,PD,PA,PR,PS,IP,SC,SP,
  419.         CI,AA
  420.  
  421.         Even though the LB,SI,SR,DF,DI & DR commands are parsed and
  422.         used to display the image on the initial preview screen, they are
  423.         not supported as the drawing is being created in Extended memory.
  424.         This won't usually pose a problem since this program was designed
  425.         to view HPGL files created by CADD programs and most of those
  426.         programs represent Text, Circles etc. as vector elements.
  427.  
  428.         WARNING:  Only plot files which were created as C size or smaller
  429.         should be viewed, since the program does no checking for elements
  430.         which could be drawn 'off' the page if too big.  This check was
  431.         omitted to speed up the drawing.
  432.  
  433. DELETING FILES:
  434.         While the file list is displayed on your screen, you may delete
  435.         a file by moving the cursor to it and pressing <DEL> on the
  436.         keyboard.  To delete multiple files, mark them with the <spacebar>
  437.         or Right Mouse Button and then press <DEL>.  You will be asked
  438.         to confirm each deletion.
  439.  
  440. SEARCHING FILENAMES:
  441.         While the file list is displayed on your screen, you may select
  442.         files by searching their filenames for a specific string.  The
  443.         file will be selected if it contains the exact string anywhere
  444.         in its filename.  Don't use the wildcard characters * or ? since
  445.         they will be search for literally.
  446.  
  447. SPECIAL KEYS WHILE VIEWING:
  448.    While viewing images in a VESA mode (other than arrays):
  449.  
  450.         F1/F2    Increase/Decrease RED
  451.         F3/F4    Increase/Decrease GREEN
  452.         F5/F6    Increase/Decrease BLUE
  453.         F7/F8    Increase/Decrease RED
  454.         F9/F10   Increase/Decrease RED
  455.         ALT F9   Change to Gray tones
  456.         ALT F10  Restore original palette
  457.         P        Send XMEM contents to printer as B&W image
  458.         J        Send XMEM contents to printer as Color image
  459.         G        Create a GIF file (256 c) of screen contents
  460.         Z        Create a PCX file (256 c) of screen contents
  461.         C        Crop an image and save as GIF or PCX file (256 c)
  462.         S        Scale XMEM contents to screen and save as GIF or
  463.                   PCX file (256 c)
  464.         V        Display the current VGA palette
  465.  
  466.    While viewing an array:
  467.  
  468.         G        Create a GIF file (256 c) of screen contents
  469.         Z        Create a PCX file (256 c) of screen contents
  470.         C        Crop an image and create a GIF or PCX file (256 c)
  471.  
  472.    While viewing IMG or HPGL files in a B & W mode:
  473.  
  474.         P        Send XMEM contents to printer
  475.         I        Create an IMG file (2 c) of entire XMEM contents.  The 'I'
  476.                  option may also be used if you are viewing an IMG or
  477.                  HPGL file in a color VESA mode.
  478.         Z        Create a PCX (2 c) file of entire XMEM contents.
  479.  
  480.    In both Color and B & W modes you may pan screen with:
  481.       (make sure the NUMLOCK key is on to use keypad)
  482.  
  483.         HOME     Top left of image
  484.         END      Bottom right of image
  485.         Page Up  Move up approx. 1 inch
  486.         Page Dn  Move down approx. 1 inch
  487.         ESC      Return to File Selection Menu
  488.  
  489.    The arrow keys on either numeric keypad or separate arrow keypad
  490.    pan the image approx. 1/4 inch in that direction. In addition, on
  491.    the numeric keypad, the 1,3,7 & 9 keys pan the image diagonally and
  492.    the 5 pans to center of image.
  493.  
  494.    Use the Control key with left or right arrows to pan 1 inch to the
  495.    left or right.
  496.  
  497. SAVING SCREEN AS a GIF or PCX FILE:
  498.         While viewing an image in a VESA mode, pressing <G> will save the
  499.         current screen (not necessarily everything in Extended memory) to
  500.         a GIF file with the filename of your choosing.  Pressing <Z> will
  501.         save to a PCX file.  The dimensions will come from the mode you
  502.         are currently viewing the image in or the cropped size that you
  503.         used.  The color table written to file will reflect any adjustments
  504.         you've made with the Function keys.
  505.  
  506. CROPPING SCREEN & SAVING AS a GIF or PCX FILE:
  507.         If you press <C> you will be able to crop your screen image before
  508.         saving as a GIF or PCX file.  You will see a box drawn around your
  509.         complete image when you first press <C>.  Press a <T> to move the
  510.         TopLeft corner of box.  Press <B> to move the BottomRight corner.
  511.         Use the arrow keys to move a single pixel at a time, or PageUp,
  512.         PageDown, <CTRL>Leftarrow or <CTRL>Rightarrow to move 10 pixels at
  513.         a time.  <HOME> will move the Topleft corner of box to Topleft of
  514.         screen.  <END> will move the Bottomright corner of box to Bottomright
  515.         of screen.  <ESC> will abort and a <CR> will start the screen save.
  516.         You will be prompted whether to save as GIF or PCX file.  See 'Using
  517.         a Mouse' below.
  518.  
  519. SCALING XMEM CONTENTS TO SCREEN & SAVING:
  520.         If you press <S> you will be able to scale the entire image in
  521.         XMEM to your screen.  You will see a box drawn the screen when you
  522.         first press <S>.  If you just press the <CR> key at this time, your
  523.         entire image will be fitted to your screen at the current VESA
  524.         resolution.  Use the arrow keys etc. (like in cropping above)
  525.         to move the lower right corner of box.  Scaling always occurs
  526.         about the upper left corner of image, so you can't move this point.
  527.         <ESC> will abort and a <CR> will start the screen save.  See 'Using
  528.         a Mouse' below.
  529.  
  530. SAVING XMEM CONTENTS AS a IMG FILE:
  531.         While viewing a 2 color Black/White image (either IMG, 2-color
  532.         PCX or HPGL files), pressing an <I> will save the entire eXtended
  533.         memory contents to a IMG file, or pressing <Z> will save as a
  534.         2-color PCX file.  You will have the opportunity to reverse the image
  535.         before saving.  It doesn't matter whether you are viewing the image
  536.         in a color VESA mode or one of the Black & White modes in order to
  537.         save with the <I> mode, as long as the original image was actually
  538.         a 2 color image.  Currently, there is not a cropping option before
  539.         saving as a IMG file.  However, if you are viewing the 2-color image
  540.         in a color VESA mode, you could save out as a cropped GIF or PCX file.
  541.  
  542. PRINTING IMAGES:
  543.         Before displaying an image that you will be printing, you should pull
  544.         up the Printer Setup Menu (submenu of QUALS menu) and make any
  545.         necessary changes for size, margins and rotation etc.  After an
  546.         image is displayed, any adjustments to color/brightness/contrast will
  547.         be reflected in your print.
  548.  
  549.         While a color image file is displayed on the screen,
  550.         pressing <P> will create a Black & White print on your active
  551.         printer.  A halftoning process is used to achieve an excellent
  552.         reproduction of the screen.  Pressing <J> will create a Color
  553.         print on your active color printer.  You may cancel the plot by
  554.         pressing <ESC> during the plot.  The port defaults to LPT1 unless
  555.         you specified a command line argument of /L2 when starting the
  556.         program.  The actual plot will be of your entire image (stored in
  557.         extended memory) and not just what you may be viewing on your
  558.         screen.
  559.  
  560.         While viewing an IMG (black & white), or HPGL (.PLT or .HPG) plot
  561.         file, pressing <P> will create a print.  The maximum size of image
  562.         is limited only by amount of free Xmem you have.  The maximum size
  563.         of print is 10.5 x 8.0 inches.
  564.  
  565.         See description of /FB, /FW & /FN above to preserve image context
  566.         when your print is being scaled down from original size. You can use
  567.         any of the printer qualifiers (available as command line qualifiers
  568.         or from the Printer Menu within program) to change the defaults for
  569.         Printer Port, Printer Type, Resolution, Rotation Angle, Width and
  570.         Top & Left Margins.  (See above descriptions)
  571.  
  572.         If you select a Print Width greater than 8.5", the program will
  573.         automatically rotate print 90 degrees (unless 270 was already
  574.         selected).  The program will beep if you try to use an invalid
  575.         combination of size, rotation angle or resolution.
  576.  
  577. MOUSE USE:
  578.         In most cases where the keypad is used to move the text cursor, a
  579.         MicroSoft compatible mouse can also be used.  You must install
  580.         any required mouse drivers before running VESAVIEW.
  581.  
  582.         The Left button is used just like the <CR> key on the keyboard to
  583.         display one image. It is also used to select choices from pop-up
  584.         menus, to select commands at the bottom of screen and to select the
  585.         PageUp and PageDown icons from the vertical bar on the right side
  586.         of screen.
  587.  
  588.         The Right button is used just like the <ESC> key on the keyboard
  589.         to abort displays and menus.  It is also used to mark files for use
  590.         in arrays or for displaying them as slides (like the <spacebar>).
  591.  
  592.         If a large image has been displayed in one of the 256 color VESA
  593.         modes, holding down the Left mouse button will display a panning
  594.         icon on your screen.  The green box represents your entire image
  595.         size and the red box represents your screen size.  While holding
  596.         down the Left button, move the mouse and the red box will pan
  597.         around with the green box.  When you let go of the button, the
  598.         screen with be moved to reflect your new window area.  This mode
  599.         of panning is much quicker than using the arrow keys, although you
  600.         will probably use the arrow keys for fine tuning the pan.  If a
  601.         double-beep is heard when trying to use this feature, your image
  602.         is probably smaller than your screen and no panning is possible.
  603.  
  604.         When Cropping an image, the Left mouse button will move the upper
  605.         left corner of the cropping box and the Right mouse button will
  606.         move the lower right corner of box.  Pressing both the Left and
  607.         Right buttons simultaneously will start the save (like pressing
  608.         <CR>).  Scaling works the same except the Left mouse button is
  609.         not used (can't move the upper left corner of scaling box).
  610.  
  611. CAUTIONS:
  612.         The array used to store the files in current directory is limited
  613.         to 400 files.
  614.  
  615.         The program determines the type of file to display by the extension
  616.         used on the filename.  Supported extensions are PCX, GIF, BMP, TGA,
  617.         IMG, TIF, HPG and PLT.  Any other extensions are ignored.  Incorrect
  618.         extensions may cause program to hang  (ie. Don't name a PCX file
  619.         with a GIF extension).
  620.  
  621.         Even though your VESA driver thinks it supports some of the higher
  622.         resolution modes, your hardware may not have the required memory
  623.         to do so.  Therefore, you need to lockout these modes from the
  624.         program with the /LOmode command line switch.  If you don't lock
  625.         out these modes, the program may hang and you'll have to do the 3
  626.         finger trick (<CTRL> <ALT> <DEL>).
  627.  
  628.         When printing, make sure your printer is online before pressing
  629.         the <P> or <J> keys, otherwise the printer may lose some of the
  630.         data or lock up the program.
  631.  
  632.  
  633. ERRORS:
  634.         Most errors will display an appropriate message.  However, if you
  635.         are in graphics (such as displaying an array of images), error
  636.         messages will not display but you will hear 2 beeps.
  637.  
  638. HINTS:
  639.         When creating arrays of images that include 24 bit files, you may
  640.         want to toggle the 24 bit palette option to STANDARD to speed up
  641.         the processing. The color detail will not be too apparent at this
  642.         small scale.
  643.  
  644.         If you are using a printer supported by the DOS GRAPHICS command,
  645.         you can get a quick print of a Black & White screen by using the
  646.         GRAPHICS command before running VESAVIEW.  Version 5.0 of DOS
  647.         supports the DeskJet & LaserJets and the syntax would be:
  648.                 GRAPHICS DESKJET /r     (the /r will reverse black & white)
  649.         Use <SHIFT><PRT SCRN> while graphics are on the screen to initiate
  650.         the print.
  651.  
  652.         When printing to a color printer, if your image looks like it needs
  653.         to be lightened up slightly, try increasing the Gamma value instead
  654.         of the brightness.  This will lighten up only the lower intensities
  655.         and leave the higher intensities as they are.
  656.  
  657.         Besides using the SCALE option, there is a trick you can use
  658.         to scale down an image by 1/2,1/3,1/4...1/9.  Mark just one image
  659.         and display it as an array.  Select the Array Size according to the
  660.         scale factor you wish to use. (The color table used to display a
  661.         single image as an array will be the true color table of that image
  662.         and not the standard palette).  After the image is displayed, use
  663.         the CROP feature to save the area you desire as a GIF image.  Note
  664.         that when a single array image is displayed, the background color
  665.         and text colors will change according to the color table of the
  666.         single image being displayed.
  667.  
  668.         If you need a VESA driver for your graphics card, login to
  669.         Compuserve and go to the IBMPRO forum (GO VESA).  In Lib #12
  670.         (Vesa), you will find VESA drivers for almost any card.
  671.  
  672.         If you are not sure what graphics card you have in your machine,
  673.         there is a great little program in the GRAPHSUPPORT forum on
  674.         Compuserve (GO PICS).  In Lib #14 (Misc Util & Code) download
  675.         VDEOID.EXE.  This program will try and determine the card
  676.         manufacturer & memory on it.
  677.  
  678. CARDS TESTED:
  679.         This program has been tested on the following computers and
  680.         graphics cards:
  681.  
  682.         DELL 325D - Using built-in Paradise card
  683.         DELL 325D - Using a CompuAdd Hi-rez card
  684.         DELL 433D - Using Trident 8900 card
  685.         DELL 433P - Using built-in Paradise card
  686.         DELL 433P - Using a Video-7 VRAM II card
  687.         DELL 486D/50 - Using built-in Paradise card
  688.         NEC 386SX - Using a CompuAdd Hi-rez card
  689.         AST 286/386 Premium - Using Orchid Designer Pro card
  690.         AST 286/386 Premium - Using Diamond Stealth card
  691.                               (has built in VESA Bios on card)
  692.         IBM 286 AT - Using a Paradise VGA Plus
  693.         IBM 286 AT - Using a ATI Wonder card & ATI Vantage
  694.         GATEWAY 2000 486/33 - Using an ATI Ultra card
  695.  
  696. SUPPORT:
  697.         If you have any comments, suggestions or questions, please leave
  698.         me a message in the GRAPHSUPPORT forum (GO PICS) on Compuserve.
  699.         My CIS ID number is 71170,2340.  The current shareware version of
  700.         VESAVIEW will always be posted in the LIB #3 (Decoders & Encoders)
  701.         of the GRAPHSUPPORT forum on Compuserve.  The Zipped archival of
  702.         VESAVIEW will usually be named  VEVIxx.ZIP  where xx is the version
  703.         number or VESAVW.ZIP.  If you can't find it by filename, try
  704.         searching for the keywords VESA and HPGL.  You can also reach me at
  705.         the P. O. Box listed in the Registration section.
  706.  
  707.